home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Grab Bag
/
Shareware Grab Bag.iso
/
002
/
pceditor.arc
/
EDITOR.DOC
< prev
Wrap
Text File
|
1986-11-16
|
29KB
|
977 lines
Welcome to the crash course on learning how to use PC Editor.
This editor is written for quick and dirty edit jobs. It's
small in size so it will not take much needed space away from
the system. Also its size allows the DOS to load and execute it
faster. First topic to learn is the function keys. Only the
first five are define and they are as follows:
F1 - Page forward 20 lines (PgDn also works the same).
F2 - Page backward 20 lines (PgUp also works the same).
F3 - Page down 1 line at a time.
F4 - Insert lines. Must Press This Key Before Adding New Lines.
F5 - Redisplays page. Used usually after inserting lines (F4).
(Time to either press F1 for the next page or F3 for the next line)
Now since you got a feel for paging in the editor, it is time to learn
more about the editor's abilities. This is a command driven editor
with very simple and few commands to remember. Most of them are quite
common and can be easily related to other PC programs such as MS-BASIC.
All commands are keyed and entered on the top line. This will be refered
to as the "command line" from now on. Any command can be entered on
this line at any time. After the command is executed, a reply to the
execution is displayed on the second line. This will be refered to as
the "reply line" from now on. Most of the editor's commands are not
needed by everyone but are still there just in case. For the size of
the editor, you might be suprised by the preformance and power.
How to LOAD a File into the Editor:
The editor accourse has a command to do this and probably is the most
common used command. All you have to do is type on the command line
the word "LOAD" followed by a file name. The first page of the file
will be display after it is loaded. After editing a file, you must
save the changes to the disk drive.
How to SAVE a File from the Editor:
The Editor won't ever save a file for you. After making the
changes needed, you must type on the command line the word
"SAVE" followed by a file name or an asterisk (*). The asterisk
will tell the editor to save the file under the last file name
used which is displayed at the bottom of this screen in the center.
But what if someday a new file needs to be created? Read on.
How to CREATE a File on the Editor:
To create a new file, just type on the command line the word "CREATE"
followed by a filename. The editor will clear the present file
and put you in the insert (F4) mode with the cursor in the text
area. This does not create a file on any device. You must be
sure to use the SAVE command to have it written to the disk.
How to list the FILES on a disk drive:
All you must do is type "FILES" on the command line and press enter.
The screen will clear and a list of files for the default drive will
be displayed. If you would like to see the filenames of a drive other
than the present default drive, type the drive letter followed by a
colon after the command "FILES". To get back to the edit file, enter
the command "LIST".
How to get OFF the Editor:
After you are finished editing a file, this command will take you
back to DOS. Be sure though you understand that this command does
not save any files. If changes are made to a file and the changes
are to be save, be sure to use the "SAVE" command first. Also, there
are not any backup file created by this editor.
If you find this program of use, please send $20.00 to:
Douglas McLean
P.O. Box 94064
B'ham, Al 35220
This entitles you to a current version of the Editor
and your name will be added to a list for future updates.
Please send along any suggestions for future additions to
the Editor.
Please pay by either check or money order. Make checks
payable to Douglas McLean. Also be sure to include your
name and address with zip code for future references.
Allow 2 to 3 weeks for delivery of the latest version
diskette.
This program is being distributed under the guidelines of
Freeware. The price only covers the cost and the trouble
of producing this product. Future update versions will
have a small additional charge of $5.00 a diskette.
PC EDITOR Page 1 of 15
Quick Reference
CAPS (#1),#2
Changes all alphabetic letters to upper case.
CHANGE |*string1*string2*| (line1),line2
Replaces all occurances of string1 with string2.
CHDIR (PATH)
Changes directory.
CLEAR (none)
Clears the screen.
CLS (none)
Clears the screen.
COLOR |#1|,#2,#3,#4
Changes colors for the screen.
CREATE |(d:)(path/)(filename.ext)| or |*|
Clears memory for a new file to be entered.
CURSOR (none)
Changes cursor size.
DELETE |(#6),(#2)|
Deletes a group of lines
DOS (command) (filename)
Allows for DOS command to be entered.
DRIVE (A),B,C ... etc
Changes or displays default drive.
DUPLICATE |#1,#2,#3|
Repeats a group of lines
EXECUTE |(d:)(path)(filename.ext)|
Executes the program listed.
FILES (none)
Directory of the default drive.
FIND |*string*|
Displays first occurance of string.
-- 1. --
PC EDITOR Page 2 of 15
KILL |(d:)(path/)(filename.ext)| or |*|
DELETES the FILE specified from a disk drive.
LIST (#)
List file with line specified. Default is 1.
LOAD |(d:)(path/)(filename.ext)| or |*|
Loads a file specified from a disk drive.
MERGE |(d:)(path/)(filename.ext)| or |*|
Merges a file from disk to the end of a file in memory.
MKDIR |path|
Makes a sub-directory.
MOVE |#1,#2,#3|
Moves a group of lines in the file in memory to a new location.
OFF (none)
Returns to system program.
PRINT (#1),#2
Prints the file in memory or the lines specfied.
RMDIR |path|
Deletes a sub-directory.
SAVE |(d:)(path/)(filename.ext)| or |*|
Saves a file specified to disk.
SPLIT |(d:)(path/)(filename.ext)| or |*|
Splits a file into multiply files.
SUBMIT (none)
Sends file in memory to RJE.
TABS |#1|,#2,...,#10
Changes tab key settings.
+ (none)
Displays last command on the command line.
- (none)
Executes last command entered again.
-- 2. --
PC EDITOR Page 3 of 15
DEFINED KEYS
Key Function
F1 Pages twenty lines forward.
F2 Pages twenty lines backward.
F3 Advances one line forward.
F4 Insert up to ninteen lines.
F5 Updates present screen.
(All other FUNCTION KEYS are undefined)
CTRL-END Erases to the end of the line from
the current cursor position.
CTRL-BRK Stops certain processes while executing.
SHIFT-PrtSc Prints present screen on the printer.
END Positions the cursor to the last character
of a line.
PgUp Pages twenty lines backward. (same as F2)
PgDn Pages twenty lines forward. (same as F1)
-- 3. --
PC EDITOR Page 4 of 15
COMMENTS:
When an asterisk (*) is used in a command, the editor will take the
default file name and use it. The default file name is displayed on the
bottom line in the center.
When entering a command, only the first three characters of the
command need to be entered except for commands one character in length.
To have a blank line, there must be atleast one character (or a
space) on that line. The longest line allowed is 253 characters.
To erase a line completly from the screen, press CTRL-END keys
simultaneously. This will erase all the characters on a line from
the cursor location until the end of the line.
This program requires minimum 128k of memory and DOS version 2.0
to work properly.
The percentage displayed on the bottom line is the amount of memory
left for your file out of the initial 64k work block.
The largest file that can be created or edited is 65,535 bytes long.
To keep the size of the file down, use the standard tabs instead of the
space bar. If the tab key is redefined by using the TABS command, this
rule does not apply.
The user can create a file called AUTOEXEC.ED that is composed of
commands for the editor. Everytime the editor is executed it will look
on the default drive for this file. If it is found, each line will be
executed as a separated command. When creating this file, each command
can only be eighty characters in length. If larger, only the first
eighty columns are used.
On certain editor functions the CONTROL BREAK key can be used to
terminate the process. The functions included are PRINTing, listing the
FILES, and when the AUTOEXEC.ED is executing.
When using the DOS command, the user should be sure to have the same
COMMAND.COM file version on the default drive that the system is booted
up under. Not having this will cause serious problems.
When specifing a string in such commands as SCAN and EDIT, a
character can be represented by it's hexidecimal equivalent. For
example an "*A*" would be "*&H41*". All other unprintable characters can
be edited this way except the CR and LF at the end of each line.
-- 4. --
PC EDITOR Page 5 of 15
When your are trying to LOAD a file larger than 64k into the
Editor, a message will appear requesting you to use the SPLIT command.
This will SPLIT a file into segments of 75% of 64k. The file being
split must reside on a disk drive. The new files will be created on
the default drive with names ranging from SPLIT.001 to SPLIT.999.
If SPLIT files already exist, the numbering will continue with the
next highest numbered extension. To join the files back together,
use the DOS command COPY.
Example: DOS COPY SPLIT.001+SPLIT.002 EDIT.DAT
-- 5. --
PC EDITOR Page 6 of 15
CAPS (Changes to upper case letters)
Command
Purpose: Change all of the lower case letters to upper case.
Format: CAPS (#1),#2
Remarks: All letters between a lower case "a" and "z" will be changed
to it's respective upper case letter. The line numbers are
optional. If only one line number is supplied, the letters
from that line on down are changed. But if two line numbers
are supplied, then the letters within the lines are changed.
CHANGE (Edit a string)
Command
Purpose: Replaces all occurances of the first string to the contents of
the second string.
Format: CHANGE |*string1*string2*| (line1),line2
Remarks: All occurances of the first string are replaced by the
contents of the second string. Strings can be in lenght up to
fifteen characters. The first string must be atleast one
character, but the second string can have a length of zero.
Changing starts with the top line on the screen unless a
starting line with or without an ending line is given after
the strings.
CHDIR (Change Directory)
Command
Purpose: Change the DOS current directory of the specified or default
drive.
Format: CHDIR ((d):path)
Remarks: DOS will change the current directory to the directory
specified, and now will use this directory as the default. If
a directory is not specified, the path of the default drive is
displayed.
CLEAR (Clears the screen)
Command
Purpose: Clears the current screen.
Format: CLEAR or CLS
Remarks: When this command is entered, the page location is reset to
the first page in memory.
-- 6. --
PC EDITOR Page 7 of 15
COLOR (Changes the colors for display)
Command
Purpose: Change the current colors displayed on the color monitor.
Format: COLOR |#1|,#2,#3,#4
Remarks: On the color monitor, the colors can be changed from the
default by using this command. The first number determines
the color for the text being edited. The second number
changes the color for the command line, the reply line, and
the status line. The third number changes the color for the
frame around the screen. The fourth number changes the color
of the column lines. If the fourth number is not specified,
the second is used as the default.
CREATE (Creates a new file)
Command
Purpose: To clear memory and rename the default file for a new program.
Format: CREATE |(d:)(path/)(filename.ext)|
Remarks: When this command is entered, the previous file in memory is
erased and can not be retrieved. The cursor is position in
the insert mode ready for input.
CURSOR (Changes the cursor size)
Command
Purpose: Changes the size of the cursor to a full block.
Format: CURSOR
Remarks: The first time the command is entered the cursor will change
to a full block. The second time it is entered the cursor
will return to it's original size.
DELETE (Deletes lines)
Command
Purpose: Deletes a group of lines at one time.
Format: DELETE |#1,#2|
Remarks: To delete a line or a group of lines, enter the first line
(number) to be deleted followed by the last line (number) to
be deleted. Only one hundred lines can be deleted at one time.
-- 7. --
PC EDITOR Page 8 of 15
DOS (Enter DOS commands)
Command
Purpose: Allows for a DOS command or file to be executed.
Format: DOS (command) (parameter)
Remark: To enter a DOS command, type DOS followed by the command
desired. By entering just the DOS command alone allows you to
get into another copy of the command processor. To get back
to the Editor, type EXIT at the DOS prompt and press enter.
DRIVE (Change drive)
Command
Purpose: Changes the default drive to the one specified.
Format: DRIVE |A|,B,C
Remark: To change the default drive, specify the new drive after the
command. If a drive is not specified, the reply message
'DEFAULT DRIVE IS ?' is returned.
DUPLICATE (Duplicate lines)
Command
Purpose: Duplicate a group of lines to a new location.
Format: DUPLICATE |#1,#2,#3|
Remarks: This command can be used to duplicate a group of lines to a
new location. The first line (number) specified is the start
of the group of lines. The second line (number) specified is
the ending of the group of lines. The third line (number)
specified is the insert point for the group of lines. Only 20
lines can be duplicated at one time.
EXECUTE (executes a program)
Command
Purpose: Executes another program from the editor.
Format: EXECUTE |(d:)(path/)(filename.ext)(parameter)|
Remarks: This command will execute another program from within the
editor. The file must have either an EXE or COM extention.
After the program has completed execution, the system will
return to the editor. The file in memory will still be present
for editing. Possible errors returned are INSUFFICIENT MEMORY,
FILE NOT FOUND, and ERROR IN EXECUTION.
-- 8. --
PC EDITOR Page 9 of 15
FILES (List directory)
Command
Purpose: Lists the current directory.
Format: FILES (d:)(path/)(filename.ext)
Remarks: The files command gives a listing of the files on the current
directory, sub-directory, or the one that is specified.
FIND (scans the file in memory)
Command
Purpose: To find the first occurance of a string.
Format: FIND *string1*
Remarks: This command will allow you to find the first occurance of a
string up to fifteen characters in length. The minus sign (-)
can be used after this command to find the next occurance.
When all of the occurances of a string have been found, a
message will be displayed.
KILL (Deletes file)
Command
Purpose: Deletes the file specified from a disk drive.
Format: KILL |(d:)(path/)(filename.ext)|
Remark: The file specified or the default file will be DELETED from
the directory of the disk drive.
LIST (Displays text)
Command
Purpose: Display the file loaded on the screen.
Format: LIST (#)
Remarks: The list command displays the beggining page of the text on
the screen. A line number can be specified and a page beg-
gining with that line will be displayed. If the line number
is greater than the actual number of lines, the end of file
line is displayed. Paging back by using F2 will display the
last page of the file in memory.
-- 9. --
PC EDITOR Page 10 of 15
LOAD (Loads files)
Command
Purpose: Loads a file from a drive to be edited.
Format: LOAD |(d:)(path)(filename.ext)|
Remarks: With this command the user can load a standard ASCII file for
updates. The file can be up to 64k bytes an length. This
command changes the default file and remembers what drive it
was read from.
MERGE (merges files)
Command
Purpose: Merges a file from a drive to an existing file in memory.
Format: MERGE |(d:)(path/)(filename.ext)|
Remarks: This command is used to load a file from a disk drive into
memory after the present file loaded. The default file name
stays unchanged.
MKDIR (Makes directory)
Command
Purpose: Makes a new sub-directory on the default drive.
Format: MKDIR |(d:)path|
Remarks: In making a new sub-directory specify the ASCII string as
defined in the DOS manual. A sub-directory will be made on
the default drive in the current directory.
MOVE (transfer lines)
Command
Purpose: To move a group of lines from one location in the file to a
new location.
Format: MOVE |#1,#2,#3|
Remarks: The first line (number) specified is the starting location of
a line or a group of lines. The second line (number)
specified is the ending location of that group of lines to be
moved. The third line (number) specified is the insert point
for the group of lines.
-- 10. --
PC EDITOR Page 11 of 15
OFF (Exit program)
Command
Purpose: The OFF command returns the user back to DOS.
Format: OFF
Remarks: You will be returned to the DOS operating system. If a color
monitor is being used, the frame color will remain the same.
PRINT (Prints the file on memory)
Command
Purpose: This command is used for a listing of the file in memory on
the printer.
Format: PRINT (#1),#2
Remarks: If you wants to print the whole listing, the "PRINT" command
without any line numbers can be used. To print only a portion
of the file, line numbers can be specified. The file will be
printed from the first line listed until the last line listed.
If the second line is not listed, the file is printed from the
first line number until the end of the file.
RMDIR (Removes a directory)
Command
Purpose: Removes a sub-directory from the specified or default drive.
Format: RMDIR |(d:)path|
Remarks: In removing a sub-directory specify the ASCII string as
defined in the DOS manual. In order to delete a sub-
directory, the directory must already be empty.
SAVE (saves a file from memory)
Command
Purpose: To save the present file being edited to a disk file.
Format: SAVE |(d:)(path/)(filename.ext)|
Remarks: With this command you can save a file in a standard ASCII form
The file saved can be up to 64k bytes in length. The default
file name will be changed.
-- 11. --
PC EDITOR Page 12 of 15
SPLIT (splits a file into multiply files)
Command
Purpose: To split a file to large for editing into smaller files.
Format: SPLIT |(d:)(path/)(filename.ext)|
Remarks: The SPLIT command is used when a file is to large to fit into
memory (over 64k). The amount of files created will be
determined by the size of the input file. Each file created
will have a maximum length of 75% of 64K, allowing enough room
for editing. The filenames for the split file will be
SPLIT.001 to SPLIT.nnn. The numbering will start after the
highest numbered extension. This command allows a user to get
around the limitation of only being able to edit a 64k length
file. To join the SPLIT files back together again, use the
DOS command COPY.
SUBMIT (send a program to the main computer)
Command
Purpose: To send a file out the async port.
Format: SUBMIT
Remarks: The file must be already loaded into memory of the editor.
When this command is entered, the file will be sent through
the asynchronous adapter at the default baud rate of the
editor or a baud rate set by using the DOS MODE command.
There is no way of breaking in the middle of sending a file
and there is not any Hand Shaking between devices.
(Enter on the command line to set the default Baud Rate.)
DOS MODE COMn:baud,parity,databits,stopbits
TABS (set tabs)
Command
Purpose: To set the tab columns for the tab key.
Format: TABS |#1|,#2,...,#10
Remarks: The tab key can be changed from the default values to a new
set of values. You can define up to ten tab settings for a
row on the screen.
+ (plus)
Command
Purpose: Displays previous command.
Format: +
Remarks: This command displays the command previously entered. The
command is only displayed, not executed.
-- 12. --
PC EDITOR Page 13 of 15
- (minus)
Command
Purpose: Executes previous command.
Format: -
Remarks: This command executes the previous command entered. When
using commands such as SCAN, the minus command is helpful.
-- 13. --
PC EDITOR Page 14 of 15
RETURN MESSAGES
What do such messages mean.
MESSAGES REASON
ACCESS DENIED The path can not be accessed.
DEFAULT DRIVE IS |A| Gives the present default drive.
DIRECTORY OF DRIVE |A| The directory of the default drive
was given.
ENTER COMMAND The editor is waiting for a
command to be entered.
ERROR IN EXECUTION While execution of another program,
an error occured.
FILE NOT FOUND The file specified was not located
on the drive searched.
FILE TO LARGE TO LOAD - The file specified on a load is
USE THE SPLIT COMMAND larger than 64k.
FILE TO LARGE TO MERGE - The file specified on a merge is
USE DOS COPY COMMAND too large to fit in the remaining
portion of unused memory.
IMPROPER LINE NUMBER The line for that number does not
exist in the text.
INSUFFICIENT DISK SPACE Not enough space on the disk drive.
INSUFFICIENT MEMORY The memory left in the text area
was not enough for the function
being performed.
INVALID COMMAND NAME The command name given is not
recognized.
INVALID DRIVE SPECIFIED Drive given is an invalid drive for
the system.
INVALID FILE SPECIFIED The file name given is incorrect
according to the DOS standards.
INVALID HEX NUMBER The hexidecimal number given is
invalid.
INVALID LINE NUMBER Line number is not numeric.
INVALID LINE SPECIFIED The sequence of the line numbers
is invalid.
INVALID STRING The string delimiters are not found.
-- 14. --
PC EDITOR Page 15 of 15
INVALID STRING LENGTH Too many characters in the string
specified.
NO FILE SPECIFIED The file name is not present in
a command.
NO COLOR MONITOR The PC being used does not have
a color monitor connected.
PATH NOT FOUND The directory specified was not
located.
PRINTER IS NOT READY Printer is either turn off or off
line.
PROCESS COMPLETED The command entered ended normally.
PROCESS TERMINATED The command executing has ended
abnormally. The problem should be
noticable.
SENDING THE FILE The file loaded into memory is
being sent through the communication
port.
STRING FOUND The string being searched for was
found.
STRING NOT FOUND The string being searched for was
not found in the remainder of the
file.
TOO MANY LINES Trying to use a group of lines
larger than what the command will
accept.
-- 15. --